home *** CD-ROM | disk | FTP | other *** search
/ Aminet 43 / Aminet 43 (2001)(GTI - Schatztruhe)[!][Jun 2001].iso / Aminet / util / mouse / WheelBusMouse.readme < prev   
Text File  |  2001-05-03  |  4KB  |  109 lines
  1. Short:    Bus Mouse wheel support
  2. Author:   rdc@mindless.com
  3. Uploader: rdc@mindless.com
  4. Version:  1.2
  5. Type:     util/mouse
  6.  
  7. At this moment (April 2001) there was only one software wheel mice
  8. driver on Ami - NewMouse.  This driver works only with serial mice,
  9. that have two serious disadvantages - them allocates serial port
  10. (useful for modem) and them have VERY SLOW update rate, with bad
  11. flickering of mouse pointer as result (typical 40fps for 2button and
  12. 25fps for 3button mice).
  13.  
  14. There are simple solution to adapt PC mice for Ami, as described in
  15. many documents - you can simply remove mouse chip and replace it with
  16. Schmitt-trigger, and mouse will be Amiga-like.  Unfortunately, this
  17. solution forced you to lose wheel and other mouse features... up to
  18. this moment. :)
  19.  
  20. Now you can add two Schmitt-trigger elements and connect wheel
  21. optopairs to joystick port pins 1 and 3.  Amiga has two similar pairs
  22. of mouse counters, and second pair will be used for mouse wheel.
  23. This driver reads second counter every vertical blank and generates
  24. NewMouse-standard input events.  It is (theoretically) fully NewMouse
  25. compatible, you can use it with any NewMouse aware applications like
  26. DirOpusMagellan.
  27.  
  28. If your mouse has two wheels, you can connect second wheel through
  29. another two Schmitt-trigger elements to joystick port pins 2 and 4.
  30.  
  31. If your mouse has only one wheel, but you want have horizontal
  32. scrolling, you can select qualifier for scrolling direction change.
  33. It may be any keyboard control key, and any button on joystick/mice
  34. ports.  You can even simultaneously use several qualifiers - for
  35. example, you can do horizontal scrolling by pressing any Shift key.
  36.  
  37. If you don't want to modify mouse, you can solder my PS/2 controller
  38. (aminet:hard/hack/ps2m.lha) and use WBM with it.  This controller
  39. fully simulates quadrature wheel signals.  Or you even can connect
  40. second mouse and use it as a scroller :-)
  41.  
  42. Full C source code included.  Installation is very simple - add
  43. following string in you startup-sequence or user-startup:
  44.  
  45. c:wbm
  46.  
  47. If you want to remove copyright message:
  48.  
  49. c:wbm quiet
  50.  
  51. If you want to reverse wheel action:
  52.  
  53. c:wbm reverse
  54.  
  55. If you want to reverse only horizontal scrolling:
  56.  
  57. c:wbm rx
  58.  
  59. If you want any Shift for horizontal scrolling:
  60.  
  61. c:wbm lshift rshift
  62.  
  63. Additional parameter - priority (0 by default):
  64.  
  65. c:wbm priority=10
  66.  
  67. Priority will be important in cases when you have continuous working
  68. program (for example, archiver) with priority higher than WBM.  WBM
  69. priority is recommended to be higher than priority of any continuous
  70. task.
  71.  
  72. Of course, you can mix options in any way.  See "wbm ?"
  73. and history for full list of options in current version.
  74.  
  75. Driver may be terminated by break signal on WheelBusMouse process.
  76.  
  77.  
  78. History:
  79.  
  80. 1.2
  81. - added two wheels support
  82. - added reverse of concrete wheel direction: RX and RY
  83. - added qualifiers for scrolling direction change as
  84.   CLI options: LMB/S,MMB/S,RMB/S,JOYFIRE0=JF0/S,JOYFIRE1=JF1/S,
  85.                JOYFIRE2=JF2/S,CTRL/S,LSHIFT=LSH/S,RSHIFT=RSH/S,
  86.                LALT/S,RALT/S,LCOMMAND=LCMD/S,RCOMMAND=RCMD/S
  87. 1.1
  88. - you don't need c:run for wbm startup anymore
  89. - driver eats less CPU time (WaitTOF() instead of Delay())
  90. - added CLI options: REVERSE/S,PRIORITY/N,QUIET/S
  91.  
  92. 1.0
  93. - initial Aminet release
  94.  
  95.  
  96. Have fun!
  97.  
  98.  
  99. ============================= Archive contents =============================
  100.  
  101. Original  Packed Ratio    Date     Time    Name
  102. -------- ------- ----- --------- --------  -------------
  103.    18009    7015 61.0% 29-Mar-01 09:59:00  gpl.txt
  104.     1624    1065 34.4% 07-Apr-01 17:51:42  wbm
  105.     5594    1982 64.5% 07-Apr-01 17:51:30  wbm.c
  106.     3286    1586 51.7% 07-Apr-01 18:00:44  wbm.readme
  107. -------- ------- ----- --------- --------
  108.    28513   11648 59.1% 08-Apr-101 23:08:30   4 files
  109.